Inside Macintosh: OpenDoc Class Reference /

Part 1 - Classes and Methods / ODStorageUnitView

SetValue

The SetValue method writes data to the focused value, starting at the offset (inclusive).

void SetValue (in ODByteArray value);

value

A byte array whose buffer contains the data to be written.

DISCUSSION

You call this method to write data to the focused value. If that value currently is a promise value, the promise is fulfilled before the data is written.

This method writes data to the focused value, starting at the current offset, and overwrites any data at and beyond the offset. If the current offset plus the length of data being written is greater than the current size of the value (as returned by the GetSize method), the size of the value is automatically increased to accommodate the new data.

When you no longer need the structure you pass as the value parameter, you should deallocate that structure and its buffer.

EXCEPTIONS

kODErrUnfocusedStorageUnit

The focus context of this storage-unit view is not a value.

If the storage-unit cursor for this storage-unit view does not represent a legal focus context for the storage unit that created this storage-unit view, this method throws exceptions raised by the FocusWithCursor method of that storage unit.

SEE ALSO

The ODByteArray type (page 877).
The ODStorageUnitView::GetSize method (page 742).
The ODStorageUnitView::GetValue method (page 745).

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help